https://gateway.iugu.com/api/v1/transactions/capture/{payment_id}
Capturar um pagamento autorizado
Captura fundos de um pagamento previamente autorizado.
- Se o pagamento já foi capturado ou cancelado, retorna 200 com o estado atual do pagamento, sem nova chamada ao adquirente.
- Pagamentos criados via
/chargenão possuem autorização e retornam 500authorization_transaction_not_found.
Sem ações implementadas definidas
Request
|
Path variables |
|
|---|---|
|
payment_id
Required Type: string ID do pagamento a ser capturado |
|
|
Headers |
|
|---|---|
|
Workspace-Id
Type: string ID do workspace. Quando ausente, é usado o workspace padrão do Gateway. Ex: 1D81KhKbYuVq9505Bz4Nk9 |
|
|
Body Content Type: application/json |
||||||
|---|---|---|---|---|---|---|
|
||||||
1
2
3
{
"amount_cents": 10000
}
Response
|
200 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Pagamento capturado com sucesso (ou já capturado/cancelado anteriormente)
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
{
"payment": {
"id": "<ID>",
"status": "<STATUS>",
"multi": [
"<MULTI>"
],
"success_ec": "<SUCCESS_EC>",
"mcc": "<MCC>",
"recurrent": "<RECURRENT>",
"card_on_file": "<CARD_ON_FILE>",
"tid": "<TID>",
"nsu": "<NSU>",
"authorization_code": "<AUTHORIZATION_CODE>",
"amount_cents": "<AMOUNT_CENTS>",
"refunded_amount_cents": "<REFUNDED_AMOUNT_CENTS>",
"cnpj": "<CNPJ>",
"workspace_id": "<WORKSPACE_ID>",
"account_id": "<ACCOUNT_ID>",
"invoice_id": "<INVOICE_ID>",
"client_ref": "<CLIENT_REF>",
"subscription_id": "<SUBSCRIPTION_ID>",
"card_id": "<CARD_ID>",
"card_bin": "<CARD_BIN>",
"card_last_four": "<CARD_LAST_FOUR>",
"currency": "<CURRENCY>",
"installments": "<INSTALLMENTS>",
"soft_descriptor": "<SOFT_DESCRIPTOR>",
"created_at": "<CREATED_AT>",
"updated_at": "<UPDATED_AT>",
"transactions": [
{
"id": "<ID>",
"function": "<FUNCTION>",
"success": "<SUCCESS>",
"tid": "<TID>",
"nsu": "<NSU>",
"arp": "<ARP>",
"acquirer": {
"payment_id": "<PAYMENT_ID>",
"status_code": "<STATUS_CODE>",
"acquirer_mac_code": "<ACQUIRER_MAC_CODE>",
"status_description": "<STATUS_DESCRIPTION>",
"request_status_code": "<REQUEST_STATUS_CODE>",
"request_status_description": "<REQUEST_STATUS_DESCRIPTION>"
},
"lr": {
"code": "<CODE>",
"source": "<SOURCE>"
},
"card_id": "<CARD_ID>",
"card_bin": "<CARD_BIN>",
"card_last_four": "<CARD_LAST_FOUR>",
"card_on_file": "<CARD_ON_FILE>",
"transaction_token_type": "<TRANSACTION_TOKEN_TYPE>",
"amount_cents": "<AMOUNT_CENTS>",
"ec_group": {
"id": "<ID>",
"name": "<NAME>"
},
"commercial_enterprise": {
"id": "<ID>",
"name": "<NAME>",
"number": "<NUMBER>",
"acquirer": "<ACQUIRER>",
"mcc": {
"id": "<ID>",
"code": "<CODE>",
"description": "<DESCRIPTION>"
}
},
"created_at": "<CREATED_AT>"
}
],
"anti_fraud": [
{
"id": "<ID>",
"payment_id": "<PAYMENT_ID>",
"provider": "feedzai",
"provider_id": "<PROVIDER_ID>",
"decision": "<DECISION>",
"omniscore": "<OMNISCORE>",
"created_at": "<CREATED_AT>"
}
]
}
}
|
400 |
|
|---|---|
|
Requisição inválida. Possíveis causas: - `invalid_parameter_error`: parâmetro inválido - `bad_request`: o adquirente rejeitou a captura (`details` traz a resposta do adquirente) |
|
1
"<SCHEMA>"
|
401 |
||
|---|---|---|
|
Não autorizado - Token de autenticação inválido ou ausente
|
||
1
2
3
{
"message": "<MESSAGE>"
}
|
404 |
||||||||
|---|---|---|---|---|---|---|---|---|
|
`payment_not_found`: pagamento com o ID informado não existe
|
||||||||
1
2
3
4
5
6
{
"error": "payment_not_found",
"service": "Acquirers::CancelService",
"details": {
}
}
|
500 |
||||||||
|---|---|---|---|---|---|---|---|---|
|
Erro interno. Possíveis causas: - `authorization_transaction_not_found`: o pagamento não possui transação de autorização bem-sucedida - `invalid_acquirer`: adquirente do estabelecimento não suportado
|
||||||||
1
2
3
4
5
6
{
"error": "payment_not_found",
"service": "Acquirers::CancelService",
"details": {
}
}